Secret Service
Secret Service Rust library.
Interfaces with the Linux Secret Service API through dbus.
This library is feature complete, has stabilized its API, and has removed extraneous dependencies, so I've made it 1.0.
Documentation
Basic Usage
Requires dbus library.
On ubuntu, this is libdbus-1-dev when building, and libdbus-1-3 when running.
In Cargo.toml:
[dependencies]
secret-service = "1.1.3"
If you have cargo-extras
installed, can replace above step with the command at the prompt in your project directory:
$ cargo add secret-service
In source code (below example is for --bin, not --lib)
extern crate secret_service;
use SecretService;
use EncryptionType;
use Error;
Functionality
- SecretService: initialize dbus, create plain/encrypted session.
- Collections: create, delete, search.
- Items: create, delete, search, get/set secret.
Changelog
0.1.0
- dependency on gmp is removed.
- rust-crypto replaced by RustCrypto.
- as a result of above, error on encrypting and decrypting blank input is fixed.
0.4.0
- gmp is now optional dependency.
- gmp upgraded to 0.3 to fix "private-in-public" warnings which will be hard errors soon.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.